home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / misc / RunLame.lha / RunLame1.28 / runlame.lha / RunLame / Docs / RLInfiltrator_V1.6.doc < prev    next >
Text File  |  1993-08-25  |  21KB  |  462 lines
  1. ____________________________________________________________________________
  2.  
  3. $VER: RunLameInfiltrator V 1.6 documentation (© by Bilbo the first of Hypenosis on 25.08.93)
  4. ____________________________________________________________________________
  5.  
  6.  
  7.                              RunLameInfiltrator
  8.                              ==================
  9.  
  10.                          (FileLinker/FileUnlinker)
  11.  
  12.                    Copyright 1992-1993 by Bilbo the first
  13.  
  14.  
  15. Accept this or delete the complete package now:
  16. ----------------------------------------------
  17.  
  18. This  software  is NOT in the Public Domain, NOT Freeware and NOT Shareware.
  19. There  are  NO  warranties, either expressed or implied, with respect to the
  20. software,  its  quality,  performance,  merchantability,  or fitness for any
  21. particular  purpose.   This software is provided "as is" and the entire risk
  22. as  to  its  quality  and  performance is with the user.  The author of this
  23. software  shall  NOT  be  liable for errors contained in the software or the
  24. software's  documentation, or for incidental or consequential damages of any
  25. kind  in connection with the performance, use or posession of this software.
  26. The  use  of  undocumented  features/commands  is  not permitted except with
  27. permission  from  the  author,  and  the author is in NO way responsible for
  28. consequences thereof.  Anyone may use it for private purposes, and it may be
  29. given  away  for  free,  as  long  as  it  is NOT part of any deal involving
  30. purchases;  and  fees for copying and/or distribution, and/or fees for disks
  31. exceeding   the   actual  market  price  for  an  empty  disk  of  the  same
  32. brand/quality  is  to  be  considered  as  commercial  exploitation  of this
  33. software,  and  an  infringement  of  the Copyrights (©) of the author.  The
  34. right to use this software and/or its documentation for private purposes may
  35. or  may  NOT  be  restricted  by  additional  copyrights and/or registration
  36. conditions.   If  given away under above (or below) conditions, the receiver
  37. in  NO  way  receives  the  ownership of the program itself, but may only be
  38. licenced  to  use  it if above and below conditions are met.  If these rules
  39. infringes   the   local   law  and/or  rights  of  any  area,  political  or
  40. geographical,  this  software  is NOT to be used and/or distributed in these
  41. areas.
  42.  
  43. For  further license and terms for software originating from Bilbo the first
  44. consult the file Copyright.notice which came with this package.
  45.  
  46. This package is PrayWare, please read the file PrawWare.license.
  47.  
  48.  
  49. Table of contents:
  50. -----------------
  51.  
  52.                             The aim of the game
  53.                                   Features
  54.                                 The bad news
  55.                        How to use RunLameInfiltrator
  56.                      How to use FileLinker/FileUnlinker
  57.                        Configuring RunLameInfiltrator
  58.                        Problems - solutions - corner
  59.                                  Known bugs
  60.                                 Future plans
  61.                                   History
  62.                              Thanks, greetings
  63.  
  64.  
  65. The aim of the game:
  66. -------------------
  67.  
  68. Do  you  run  your  system  using  another  screenmode than PAL or NTSC, for
  69. example  EURO72 or an AGA specific screenmode?  Have you ever tried to start
  70. a  game or demo from within this screenmode?  Have you ever been angry about
  71. those  programmers  who  do  not stick to the guidelines of programming thus
  72. producing  programs  which are not aware of the screenmode they were started
  73. out of?
  74.  
  75. Do  you  have an Amiga with 68010, 68020, 68030 or 68040 processor?  Did you
  76. ever curse those socalled coders whose programs crash your computer when you
  77. didn't  disable  the  processor's  caches and forgot to move the vector base
  78. register back to $0.l?
  79.  
  80. Lame programming is the disease, RunLameInfiltrator is the cure!
  81.  
  82. NEVER  start  RunLameInfiltrator  as stand-alone-program, it definitely WILL
  83. crash  your system.  RunLameInfiltrator MUST be linked to another program to
  84. work correctly.  This process is called `infiltration' in the following, and
  85. the  resulting  file  of  linking  RunLameInfiltrator to a program is called
  86. `infiltrated program'.
  87.  
  88. RunLameInfiltrator  is  a  Kick1.3+ tool, it may work under Kick1.0/1.1/1.2,
  89. but  I  cannot  give  any  warranty  for  this.   RunLameInfiltrator is 100%
  90. pc-relative  and  reentrant  Assembler  code,  so  you  can  link it to pure
  91. programs  and they will stay pure after linking.
  92.  
  93. Just after having degraded the display and the CPU RunLameInfiltrator starts
  94. the  program  it has been linked to.  When the program it has been linked to
  95. has  been  finished  the  display  and  CPU state is restored to the same as
  96. before starting the infiltrated program.
  97.  
  98. Summarizing  we  can  say  RunLameInfiltrator  is  a  multitasking  friendly
  99. temporary  system  degrader which, linked permanently to files, may let some
  100. bad  behaving  programs run in your system's environment (but can't give any
  101. guarantee).    If   some   of   those   `lame'  programs  don't  run  though
  102. RunLameInfiltrator has been used, they are on a higher lameness-level, which
  103. can't  be  fixed  by  RunLameInfiltrator  (this  is  definitely not a bug of
  104. RunLameInfiltrator).
  105.  
  106. I do write demos myself and you can believe, I DO KNOW how to write a proper
  107. startup code.  Consider RunLameInfiltrator beeing a startup code.
  108.  
  109.  
  110. Features:
  111. --------
  112.  
  113. The {}'s inform you about the needed system configuration for a feature.
  114.  
  115.  ·Disabling of all processor caches, burst and copyback modes.
  116.   {68020, 68030[EC], 68040[EC]}
  117.  
  118.  ·Moving vector base register (VBR) to location $0.
  119.   {68010, 68020, 68030[EC], 68040[EC]}
  120.  
  121.  ·Degrading display's screenmode to simulate old chipset (OCS).
  122.   {ECS, AGA}
  123.  
  124.  ·Degrading sprite resolution to simulate old chipset.
  125.   {AGA}
  126.  
  127.  ·Turning off sprites in a system friendly manner.
  128.   {OCS, ECS, AGA}
  129.  
  130.  ·Permanent fix for lame programs.  Fix can be removed.
  131.  
  132.  ·Infiltration of pure programs preserves the reentry ability.
  133.  
  134.  ·Infiltration of pc-relative programs preserves the location relativity.
  135.  
  136.  ·Works under Kickstarts 1.3, 1.4, 2.04, 3.0 and 3.1.
  137.  
  138.  ·Due  to  100% system conform and system friendly algorithms, future system
  139.   compatibility  is  as  high  as  possible.   Furthermore  the multitasking
  140.   environment  is not hurt or damaged by the code.  All degrading is done as
  141.   smart as possible, and the code did never crash during beta testing.
  142.  
  143.  ·verified,  tested  and safe (100% assembler) code resulted in a very short
  144.   binary (so the infiltrated programs only become a little longer).
  145.  
  146. Sounds great?  YAH - Yet another hype?  Hypenosis - Better believe the hype!
  147. But keep on reading, here comes...
  148.  
  149.  
  150. The bad news:
  151. ------------
  152.  
  153.  ·The   infiltrated   programs'   code   is  changed  permanently  (but  not
  154.   irreversible). If you don't like this, use RunLame.
  155.  
  156.  ·No GUI for FileLinker and FileUnlinker.
  157.  
  158.  ·Dangerous FileUnlinker tool (if you don't know what you are doing).
  159.  
  160.  ·The  updating  of  infiltrated programs is slightly uncomfortable (unlink,
  161.   and link again).
  162.  
  163.  ·Though  the  code  worked  very  well during the beta testing phase, there
  164.   might be nasty bugs.
  165.  
  166.  ·RunLameInfiltrator  can't be used to fix non-DOS trackloading demos, for I
  167.   don't  want  to  support this kind of loaders.  I usally like to keep good
  168.   demos  on my harddisk, which is not directly possible with `trackmos'.  So
  169.   I don't keep lame coded `trackmos'.
  170.  
  171.  ·The documentation often might use improper terms.  Please excuse this, for
  172.   I  am  not  a  native  english  speaker.   If  you  want  to  improve  the
  173.   documentation, please contact me.
  174.  
  175.  
  176. How to use RunLameInfiltrator:
  177. -----------------------------
  178.  
  179. In   comparison   to   RunLame   which   is   included   in   this  package,
  180. RunLameInfiltrator  performs  the  following  actions  (which  are RunLame's
  181. default options):
  182.  
  183.  S    = SCREEN          : degrade display
  184.  V    = VISIBLE         : the current display stays visible
  185.  NC   = NOCACHE         : disable instruction & data cache
  186.  NIC  = NOINSTCACHE     : disable instruction cache
  187.  NDC  = NODATACACHE     : disable data cache
  188.  NB   = NOBURST         : disable instruction & data burst mode
  189.  NIB  =